# JavaScript String replace() Method

JavaScript String Reference

## Example

Return a string where "Microsoft" is replaced with "W3Schools":

var str = "Visit Microsoft!";
var res = str.replace("Microsoft", "W3Schools");

The result of res will be:

Visit W3Schools!
Try it yourself »

More "Try it Yourself" examples below.

## Definition and Usage

The replace() method searches a string for a specified value, or a regular expression, and returns a new string where the specified values are replaced.

Read more about regular expressions in our RegExp Tutorial and our RegExp Object Reference.

This method does not change the original string.

## Browser Support

Method |  |  |  |  |
--- | --- | --- | --- | --- | ---
replace() | Yes | Yes | Yes | Yes | Yes

## Syntax

string.replace(searchvalue,newvalue)

## Parameter Values

Parameter | Description
--- | ---
searchvalue | Required. The value, or regular expression, that will be replaced by the new value
newvalue | Required. The value to replace the searchvalue with

## Technical Details

Return Value: | A new String, where the specified value(s) has been replaced by the new value
JavaScript Version: | 1.2

## More Examples

## Example

Perform a global replacement:

var str = "Mr Blue has a blue house and a blue car";
var res = str.replace(/blue/g, "red");

The result of res will be:

Mr Blue has a red house and a red car
Try it yourself »

## Example

Perform a global, case-insensitive replacement:

var str = "Mr Blue has a blue house and a blue car";
var res = str.replace(/blue/gi, "red");

The result of res will be:

Mr red has a red house and a red car
Try it yourself »

JavaScript String Reference

### WEB HOSTING

UK Reseller Hosting

### WEB BUILDING

FREE Website BUILDER Free HTML5 Templates

### W3SCHOOLS EXAMS

HTML, CSS, JavaScript, PHP, jQuery, XML, and ASP Certifications

### SHARE THIS PAGE

### Color Picker

### HTML/CSS

HTML Tutorial HTML5 Tutorial CSS Tutorial CSS3 Tutorial Bootstrap Tutorial

### JavaScript

JavaScript Tutorial jQuery Tutorial jQuery Mobile Tutorial AngularJS Tutorial AJAX Tutorial JSON Tutorial

### Graphics

Canvas Tutorial SVG Tutorial Google Maps Tutorial

### Server Side

SQL Tutorial PHP Tutorial ASP Tutorial ASP.NET Tutorial VBScript Tutorial AppML Tutorial

### Web

Web Building Web Statistics Web Certification

### XML

XML Tutorial DTD Tutorial Schema Tutorial XML DOM Tutorial XPath Tutorial XSLT Tutorial XQuery Tutorial XSL-FO Tutorial RSS Tutorial WSDL Tutorial

### HTML/CSS

HTML Tag Reference HTML Event Reference HTML Color Reference CSS 1,2,3 Reference Bootstrap Reference

### JavaScript

JavaScript Reference HTML DOM Reference jQuery Reference jQuery Mobile Reference Google Maps Reference

### Server Side

PHP Reference SQL Reference ASP Reference VBScript Reference Razor Reference ASP.NET Reference

### XML

XML DOM Reference XSLT Reference XSL-FO Reference XPath Reference XQuery Reference Schema Reference RSS Reference SVG Reference

### HTML Charsets

HTML Character Sets HTML ASCII HTML ANSI HTML Windows-1252 HTML ISO-8859-1 HTML Symbols HTML UTF-8

### HTML/CSS

HTML Examples CSS Examples

### Browser Scripting

JavaScript Examples HTML DOM Examples jQuery Examples jQuery Mobile Examples AngularJS Examples AJAX Examples

### Server Scripting

PHP Examples ASP Examples VBScript Examples Razor Examples .NET Examples

### XML Languages

XML Examples DTD Examples XML DOM Examples XSL Examples XSLT Examples XPath Examples XQuery Examples Schema Examples RSS Examples SVG Examples